home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 020a / pc_set.zip / PC-SETUP.DOC < prev    next >
Text File  |  1993-02-11  |  14KB  |  265 lines
  1. PC-SETUP.EXE (VERSION 1.0)                 Copyright (c) 1992 Ethan Winer
  2. -------------------------------------------------------------------------
  3.                 First Published in PC Magazine March 16, 1993 (Utilities)
  4. -------------------------------------------------------------------------
  5.  
  6. PC-SETUP:
  7.           PC-SETUP is an installation program for in-house programmers,
  8. shareware authors, data services, and others who distribute software to
  9. nontechnical users.  Supports multiple distribution disks, and automatic
  10. or manual file installation. Creates directories and subdirectories as
  11. necessary.  Requires use of PKZIP.EXE on all distribution files, and
  12. DOS 3.0 or later.
  13.  
  14.      Distributing in-house or shareware programs and file updates can
  15. produce corporate chaos when novices have to install files into multilayer
  16. directories.  Commercial-scale installation utilities guide the
  17. unsophisticated user safely through the process, but these are often too
  18. elaborate and expensive a solution for smaller-scale programmers.
  19. Engineers, hobbyists, and database services that distribute data files
  20. regularly by subscription need an install utility scaled to their needs.
  21.  
  22.      If you've got too many users to go from machine to machine and make
  23. the installation yourself, yet you're not confident that these users won't
  24. mess up the installation if you don't, what you need is PC-SETUP.
  25.  
  26.      PC-SETUP is designed to install any number of program or data files
  27. that have been compressed with the shareware utility PKZIP.  It supports
  28. multiple distribution disks and will use or create any needed directories
  29. and subdirectories on the user's hard disk. File installation can be
  30. automatic or manual, and you can include comments to guide the user.
  31.  
  32.      After the first installation, there is no need to repeat the procedure
  33. in order to install a different printer driver or other optional files.
  34. And best of all, no printed user instructions are necessary.
  35.  
  36. The utilities and programs that appear in PC Magazine may neither be
  37. distributed for a fee nor included in a commercial product.  However,
  38. because of its purpose PC-SETUP is in a somewhat different category.
  39. While it may not be sold by itself, PC-SETUP may be distributed with any
  40. software--including commercial programs--provided no additional fee is
  41. charged.
  42.  
  43.      PC-SETUP requires a minimum of 256K RAM and DOS 3.0 or later.
  44. DOS 3.0 is necessary because PC-SETUP uses interrupt services that are
  45. not available in earlier DOS versions.  In addition to PC-SETUP.EXE, you
  46. must also have a copy of PKUNZIP.EXE on your first (or only) distribution
  47. disk.  PKUNZIP is a shareware program that is available for downloading
  48. on CompuServe and other bulletin boards.  Note that if it is included
  49. with commercial software, PKWARE Inc. requires a nominal license fee.
  50. (To register PKUNZIP, send $47 to PKWARE Inc., 9025 N. Deerwood Dr.,
  51. Brown Deer, WI 53223.  To inquire about licensing fees, call 414-354-8699.)
  52.  
  53.      The program was written using Microsoft QuickBASIC 4.5. To recreate
  54. PC-SETUP from the supplied source code, you need QuickBASIC 4.0 or any
  55. later version of Microsoft compiled BASIC (including VB-DOS).
  56. When linking, you must specify the appropriate library name so that LINK
  57. can find the interrupt routine PC-SETUP uses.  The correct syntax and
  58. library names are shown below:
  59.  
  60. BC PC-SETUP /O ;
  61.   use above line for all versions
  62. LINK PC-SETUP, , NUL, QB.LIB ;
  63.   use above line for QuickBASIC
  64. LINK PC-SETUP, , NUL, QBX.LIB ;
  65.   use above line for BASIC PDS
  66. LINK PC-SETUP, , NUL, VBDOS.LIB ;
  67.   use above line for VB-DOS
  68.  
  69. USING PC-SETUP
  70.  
  71.      To begin installing from your distribution disk, the user simply
  72. enters
  73.  
  74.         d:PC-SETUP [/B]
  75.  
  76. where d: is the drive containing the .ZIP files to be decompressed and
  77. installed.  PC-SETUP detects whether a color or monochrome adapter is
  78. present and adjusts its display colors accordingly.  The optional
  79. /B switch is needed only for systems with a composite display, that is,
  80. a CGA adapter connected to a monochrome monitor.
  81.  
  82.       The three parts of the main PC-SETUP screen display the names of
  83. the .ZIP files to be installed, the drive and directory into which they
  84. will be stored, and an optional comment that will usually be used to
  85. describe each file's contents.  On-screen instructions explain each of
  86. the keys that are used by PC-SETUP, and pop-up dialog boxes are used for
  87. any warnings.  A brief status message shows the name of each file as it
  88. is being installed, further clarifying the program status.
  89.  
  90.      As explained below in the section ``Setting Up for Installation,''
  91. you may elect to have one or all of your distribution files installed
  92. automatically.  Assuming that the user is (or wants) instead to make the
  93. installation manually, he selects each .ZIP file to be installed by
  94. pressing the Spacebar. A check mark adjacent to the currently highlighted
  95. .ZIP filename is turned on or off each time the Spacebar is pressed.
  96.  
  97.      By default, PC-SETUP lists the current directory as the destination
  98. directory.  If this is not correct, the user can enter the destination
  99. directory of his choice:  The Tab key toggles between selecting .ZIP
  100. files for installation and editing the destination directories.  If the
  101. user enters a destination directory that does not exist, PC-SETUP will
  102. create it.  When installing to an existing directory, the program asks
  103. whether to warn before overwriting same-named files.
  104.  
  105.      Once all the desired files are marked and destined, the user presses
  106. F2 to begin installation.  To exit from PC-SETUP, a simple press of the
  107. Esc key will suffice.  These options are shown at the bottom of the main
  108. screen, and operating PC-SETUP should be easy enough for even the most
  109. inexperienced user.
  110.  
  111. SETTING UP FOR INSTALLATION
  112.  
  113.      Your installation can use a maximum of 99 distribution disks, each
  114. of which may contain up to 19 .ZIP files.  No single .ZIP file can be
  115. larger than the maximum capacity of a single distribution floppy disk,
  116. however.  You are not restricted to using the root directory of the disks,
  117. though you must be sure to place PC-SETUP.EXE in the same directory as
  118. PKUNZIP.EXE.  Both of these files must be located on the first distribution
  119. disk, together with your .ZIP files.
  120.  
  121.      If your installation takes more than one disk, you must create a
  122. file named NUMDISKS.n on the first distribution disk--the one that you
  123. label as ``Disk 1.''   The NUMDISKS extension, shown above as n, indicates
  124. the total number of disks and enables PC-SETUP to prompt for additional
  125. disks as they are needed.  The file itself can be empty;  the filename
  126. and extension are the information.  If you're operating under DOS,
  127. the easiest way to create an empty NUMDISKS file from the DOS command
  128. line is like this:
  129.  
  130.                    REM > A:NUMDISKS.004
  131.  
  132. SETTING DESTINATION DIRECTORIES
  133.  
  134.      In preparing your distribution disks, there are several ways to
  135. establish the default destination drive(s) and directories for the files
  136. to be installed.
  137.  
  138.           If you do nothing at all, the user's current drive and directory
  139.           will be displayed in the ``Destination Directory'' field for each
  140.           of the files being installed.  However, if the current drive is
  141.           A: or B:, PC-SETUP will substitute Drive C:.  The utility won't
  142.           attempt to unpack the files onto the distribution disk.
  143.  
  144.           You can specify a directory as the global default destination
  145.           directory by including a file named DEFAULT.DIR in the root
  146.           directory of the first distribution disk.  The one-line contents
  147.           of this file specify the path for all of the .ZIP files.  You
  148.           can create DEFAULT.DIR, either with any standard text editor
  149.           that saves files in plain ASCII form or directly from the DOS
  150.           prompt, by entering
  151.  
  152.                               COPY CON: A:DEFAULT.DIR
  153.                               C:\PRODUCT
  154.  
  155.           and then hitting F6 followed by Enter. (F6 puts a Ctrl-Z, or
  156.           end-of-file marker at the end of DEFAULT.DIR.)
  157.  
  158.           You can embed a directory name in the comment field provided
  159.           for each file by PKZIP.  Such an embedded directory name will
  160.           override the global directory specified in the DEFAULT.DIR
  161.           file (if one is present).  To see how PC-SETUP works with
  162.           PKZIP in such a case calls for a brief explanation.
  163.  
  164.     Comments can be added to .ZIP files by executing the command
  165.  
  166.                               PKZIP filename.zip -z
  167.  
  168. Normally, your comment might be, for example, ``This is the main
  169. program.'' PC-SETUP displays such comments in its right-hand column,
  170. so the user can know the purpose of a particular .ZIP file.
  171.  
  172.      In place of or appended to such a comment, you can embed a default
  173. destination path by entering the box character (ASCII 254), followed by
  174. the drive and directory. Thus, for example.
  175.  
  176.            This is the main program (ASCII 254)C:\DIRNAME
  177.  
  178. The comment will be displayed in the usual manner, but PC-SETUP will put
  179. the drive and directory in the left-hand, Destination Directory field.
  180. You can enter the box character at the DOS command prompt (and in most
  181. editors) by holding down the Alt key, typing 2,5, and 4 on the numeric
  182. key pad, and then releasing the Alt key.
  183.  
  184.      Note that whichever of the three methods you use to supply a
  185. default destination directory, users can override your suggestion and
  186. specify a different drive and directory of their own choosing.
  187.  
  188. SELECTING FILES FOR INSTALLATION
  189.  
  190.      In some cases your users may not want or need to install all of the
  191. files on the distribution disks.  For example, some companies provide
  192. source code with their products, but many people aren't interested in
  193. programming languages and may prefer not to waste their disk space with
  194. such files.  Or perhaps you distribute software that works with a variety
  195. of printers, and only one or two of several supplied drivers will be used
  196. by each customer.
  197.  
  198.      To have a file selected for installation automatically, append an
  199. ASCII 251 check mark () to the end of the comment string, but before the
  200. optional box character and destination path.  Three examples cover the
  201. possibilities:
  202.  
  203.               This is the main program(ASCII 251)(ASCII 254)C:\DIRNAME
  204.  
  205.                               or
  206.  
  207.                      This comment has no default path(ASCII 251)
  208.  
  209.                               or
  210.  
  211.                       (ASCII 251)(ASCII 254)C:\PATHNAME
  212.  
  213.      Files whose comments have no trailing check mark will not be
  214. automatically installed when the program runs, although the user may,
  215. of course, select those files manually.  Again, you can enter the check
  216. mark by pressing and holding the Alt key, and then typing the digits 2,5,
  217. and 1 when PKZIP prompts you to enter the .ZIP file comment.
  218.  
  219.      The comment portion (before the box and optional check mark) can be
  220. up to 36 characters long, and the directory name portion of the comment
  221. (after the box) can hold as many as 25 characters.  (To make the comment
  222. field as long as possible, I compromised on using only 25 characters for
  223. the directory name.)
  224.  
  225.      You can tell PC-SETUP to run a program automatically after PC-SETUP
  226. finishes by storing its name in a file named PROGRAM.RUN placed on the
  227. first distribution disk.  The name of the program must be no longer than
  228. 14 characters, since PC-SETUP stuffs the program name (plus Enter) into
  229. the keyboard buffer.  PC-SETUP is smart enough to change to the directory
  230. where the first .ZIP file was installed, on the assumption that this
  231. directory will hold the main executable program.
  232.  
  233.      If you need to execute a series of commands--for example, to load a
  234. TSR that must be present in order for the main program to operate--you
  235. can include a batch file within the .ZIP file and specify the name of
  236. the batch file in PROGRAM.RUN.  Such a batch file should be in the same
  237. .ZIP file that holds the main program, so it will be installed where DOS
  238. can find it when PC-SETUP ends.  Note that the program or batch file
  239. specified in PROGRAM.RUN is executed only when the first .ZIP file on the
  240. disk is being installed:  If PC-SETUP is rerun to install a new printer
  241. driver, for example, it would be inappropriate to run the main program at
  242. that point.
  243.  
  244. INSTALLING TO NESTED DIRECTORIES
  245.  
  246.      The only precaution you must take when your software is to be
  247. installed into nested directories is to specify that the higher
  248. directory levels be installed first.  PC-SETUP will create the
  249. directories needed if they are not already present, but it must work from
  250. the top down.  For example, if you have main files that should go into
  251. \APPMAIN and ancillary files that are to go in \APPMAIN\SUBDIR, PC-SETUP
  252. has to create \APPMAIN before it can create \APPMAIN\SUBDIR.
  253.  
  254.      If you are careful to copy the .ZIP files on your distribution
  255. disk(s) in the correct order, this will not be a problem.  Unfortunately,
  256. it is still possible for a user to create problems by changing the
  257. directory names during installation.   There is little that can be done
  258. about this and if PC-SETUP is unable to create a directory, it simply
  259. ends with an error message describing the problem.  Note: If you include
  260. a DEFAULT.DIR file, it should specify a root-level directory only (with a
  261. leading backslash) unless you are certain that the upper levels already
  262. exist.
  263. ------------------------------------------------------------------------
  264. ETHAN WINER IS A CONTRIBUTING EDITOR TO PC MAGAZINE.
  265.